home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / mc_cbv11.zip / MC_CBV.DOC < prev    next >
Text File  |  1993-03-26  |  23KB  |  445 lines

  1. ===============================================================================
  2.         Program    : MC_CBV                     Version    : 1.10
  3.         Contact    : Rod Hancock                Date       : Mar 26, 1993
  4.         Voice      : (416) 404-2756             FidoNet    : 1:229/418
  5. ===============================================================================
  6.  
  7.                                  Mc_Cbv
  8.                       Automated Callback Verifier
  9.                                   for
  10.                               RemoteAccess
  11.  
  12.                 Copyright 1992,1993 Motor City Software
  13.                           All Rights Reserved
  14.  
  15. ┌─────────────────────────────────────────────────────────────────────────────┐
  16. │▓▓▓▓▓ Introduction ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  17. └─────────────────────────────────────────────────────────────────────────────┘
  18.  
  19.   This is Motor City Software's CallBack Verification System for RemoteAccess.
  20.  
  21.   Shareware Version
  22.   -----------------
  23.  
  24.   - Works with RemoteAccess V1.1x and V2.00.
  25.   - Detects and Gives Up TimeSlices with DESQView AND OS/2
  26.   - Checks  Users Phone Numbers  to make sure they are in the correct format if
  27.     you are using USA Style numbers.
  28.   - Duplicate Phone Number Checking by  Numbers Already Called or by Numbers in
  29.     Users.BBS
  30.   - Post Welcome Message to newly verified users
  31.   - Messages are fully configurable with Message Templates
  32.   - Excellent Call Collision Handling
  33.   - Allows Multiple LOCAL Area Codes
  34.   - Sysop Configurable for  Allowing LD Callbacks,  including  Setting Specific
  35.     Hours for Long Distance calls, AND Specific Area Codes and Exchanges!
  36.   - The Sysop can define much of the displayed text.
  37.   - One of the easiest doors you ever set up!  Reads all its defaults from your
  38.     RemoteAccess configuration files!
  39.   - Originally written for the RA Beta Team
  40.   - Secure Password Checking using CRC32 with RemoteAccess 2.00
  41.   - If the User has less than  X Minutes remaining when they enter the CallBack
  42.     Door,  they will have their time reset to X minutes in order to allow them
  43.     to complete the CallBack Process. X is configurable by the Sysop.
  44.   - The Sysop may  abort  the callback by hitting  ESCAPE, or abort the current
  45.     call attempt with the SPACE bar.
  46.   - Fully Multi-Node Aware
  47.   - The Following Sysop Keys are available in the door for the Sysop :
  48.       Alt-C     Chat With User
  49.       Alt-J     Jump To Dos
  50.       Alt-R     Return To BBS
  51.       UpArrow   Add 1 Minutes Time
  52.       DownArrow Deduct 1 Minutes Time
  53.  
  54.  
  55.  
  56.   Registered Version
  57.   ------------------
  58.  
  59.   - Post Messages To Sysop based on CallBack Completion Results
  60.   - Set Validated Users Subscription Expiry Date
  61.   - Set Validated Users User Group Number
  62.   - Save verified phone numbers to the Users.Bbs (Choice of fields to save in)
  63.   - Allow McCbv to build its own LOCAL dialing control file!
  64.     YES, it will automatically verify and add local numbers to its control file
  65.     as it  finds them.  This feature alone can save you  HOURS of searching and
  66.     typing!
  67.  
  68.  
  69.  
  70. ┌─────────────────────────────────────────────────────────────────────────────┐
  71. │▓▓▓▓▓ Licensing Information ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  72. └─────────────────────────────────────────────────────────────────────────────┘
  73.  
  74.   Motor City doors are commercial programs marketed under the  "User Supported"
  75.   or "Shareware"  concept.  You  are allowed to install  this  program on  Your
  76.   system and  evaluate  it before  deciding whether to  purchase a  license  to
  77.   continue using it. This  program is not public domain or freeware. If you use
  78.   this program for more than 30  days after  successful  installation, you  are
  79.   legally required to register it or remove all working copies from your system
  80.  
  81.   The User Supported or  Shareware concept works only if  you and  your  fellow
  82.   sysops  support it.  If  you find  this program  useful, you  can register it
  83.   for only  $15.00 in U.S. funds. This  will help offset the development costs,
  84.   and encourage us to write other programs that might  be useful to  you. After
  85.   all, no one likes to work for nothing! A Registration Form is included in the
  86.   distribution archive.
  87.  
  88.   Mc_Cbv is Copyrighted 1992,1993 by Motor City Software, ALL RIGHTS  RESERVED.
  89.   You may copy this program and documentation for backup purposes. You also may
  90.   copy and  share  UNMODIFIED  copies of the  original  program  archive.   The
  91.   copyright notice  must remain attached to all copies.
  92.  
  93.   You  may not sell Motor City Software products for a fee,  or distribute them
  94.   along with other products  without written permission of Motor City Software,
  95.   nor may you modify or remove the Copyright  Notice  from the  program  or the
  96.   documentation.  BBS  operators  who  charge for  access to their  systems are
  97.   exempt from this provision as long  as no additional payment is  required for
  98.   access to Motor City Software products beyond basic file access.
  99.  
  100.   All Motor City Software products are extensively tested before being publicly
  101.   released, but as with any software, bugs may still occur. Motor City Software
  102.   products are provided  as is,  and neither  Motor City Software  nor any  BBS
  103.   operator distributing  this  software is responsible for any  damage incurred
  104.   during the operation of the program. You  are advised to test all  Motor City
  105.   Software products thoroughly on a backup copy of your BBS before putting them
  106.   online.
  107.  
  108.   Comments, suggestions and bug reports are welcome.  If you have any, you  may
  109.   call  one of the  Motor City Software  Support  Systems listed in SUPPORT.DOC
  110.   and leave a message to  the Sysop.  If you're reporting a bug, please give as
  111.   much  detail  as possible  describing the problem you are having, your system
  112.   configuration,  and if  you  would be  willing to  test  possible corrections
  113.   to the problem.
  114.  
  115. ┌─────────────────────────────────────────────────────────────────────────────┐
  116. │▓▓▓▓▓ Upgrading From Previous Version ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  117. └─────────────────────────────────────────────────────────────────────────────┘
  118.  
  119.   You will be required to delete your MC_CBV.CFG (If you don't, CBVSetup will!)
  120.  
  121.   READ this whole document as there are many changes, including NEW FORMATS for
  122.   the MC_CBV.LOC and MC_CBV.LD files. The /NOAC commandline switch is no longer
  123.   used,  as Area Code stripping is now done using the MC_CBV.LD control file.
  124.   
  125.  
  126. ┌─────────────────────────────────────────────────────────────────────────────┐
  127. │▓▓▓▓▓ Setup ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  128. └─────────────────────────────────────────────────────────────────────────────┘
  129.  
  130.   Setting Up
  131.   ----------
  132.  
  133.   Run CBVSetup to configure the CallBack Verifier.
  134.  
  135.   Online help is available by hitting the F1 Key on any field.
  136.  
  137.   CBVSetup should be fully self explanatory if you read the help screens.
  138.  
  139.  
  140.  
  141.   Running Mc_Cbv.EXE - The Door itself
  142.   ------------------------------------
  143.  
  144.   Usage: Mc_Cbv /N2
  145.  
  146.     /N Defines the node number using CBV. You may use /N*N on the optional data
  147.        line in the RA Menu option.
  148.  
  149.     Example:  D:\BBS\CBV\Mc_Cbv.EXE /N*N
  150.  
  151.     If No Command Line Parameters are used, then it defaults to NODE 1.
  152.  
  153.     Place Mc_Cbv.EXE in its own directory,  and call the  Mc_Cbv.EXE  from your
  154.     Top Menu as a type 7. It will look for the  EXITINFO.BBS  and  DORINFO1.DEF
  155.     in the  CURRENT  Directory.  It will  look for its  own files  in the  same
  156.     directory which the EXE file resides in.
  157.  
  158. ┌─────────────────────────────────────────────────────────────────────────────┐
  159. │▓▓▓▓▓ Optional Message Template Files ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  160. └─────────────────────────────────────────────────────────────────────────────┘
  161.  
  162.   Mc_Cbv will  Post Messages  to the  Sysop or User if certain Message Template
  163.   Files exist  AND you chose a  valid  Hudson Message Base in  CBVSetup.  These
  164.   files are  ASCII  Text files created using any text editor.  We have included
  165.   samples in an archive called  MESSAGES.ARJ  In each of these files,  you will
  166.   notice that line 1 contains the SUBJECT of the message. The rest of the lines
  167.   may contain whatever you like,  and the following  TextFile Control Codes are
  168.   Valid. (As used in RemoteAccess)
  169.  
  170.     ^FA - Current Users Full Name
  171.     ^FW - Users First Name
  172.     ^FO - Current Users Security Level
  173.     ^F4 - Date of Current Users FIRST Call to BBS
  174.     ^F6 - Current Users Subscription Expiry Date
  175.     ^FE - Current Users Voice Phone Number
  176.     ^FD - Current Users Data Phone Number
  177.     ^F3 - Current Users Handle
  178.     ^FB - Current Users Location
  179.     ^F5 - Date Of Birth
  180.     ^FP - Number of times the user has called your bbs
  181.     ^FH - Users A Flags (8 Characters  --XX-X-- )
  182.     ^FI - Users B Flags (8 Characters  --XX-X-- )
  183.     ^FJ - Users C Flags (8 Characters  --XX-X-- )
  184.     ^FK - Users D Flags (8 Characters  --XX-X-- )
  185.  
  186.     ^KA - Total Calls To Your BBS
  187.     ^KR - Baud Rate
  188.     ^KW - Two digit Node Number
  189.  
  190.   The following  Templates have been included,  and if they exist,  and a valid
  191.   Hudson Message Base has been chosen, will cause a message to be written. Feel
  192.   free to modify these as you see fit.
  193.  
  194.     NONEED.MSG    - Registered Version Only
  195.                     If this template exists in the same directory as Mc_Cbv.EXE
  196.                     and a user has a  high enough security level to exempt them
  197.                     from using CBV, this message will be posted to alert you.
  198.  
  199.     NOTUSED.MSG   - Registered Version Only
  200.                     If this template exists in the same directory as Mc_Cbv.EXE
  201.                     and the user for whatever reason does NOT use the CBV, then
  202.                     this will alert you.  Once the template has been posted,  a
  203.                     one line  Reason is added to the message,  explaining where
  204.                     the user Quit.
  205.  
  206.     VERIFIED.MSG  - Registered Version Only
  207.                     If this template exists in the same directory as Mc_Cbv.EXE
  208.                     then this  message will be  posted to you when the user has
  209.                     completed the callback process.
  210.  
  211.     LDUPDATE.MSG  - Registered Version Only
  212.                     If this template exists in the same directory as Mc_Cbv.EXE
  213.                     and you update LD callers without calling them back, this
  214.                     message will be posted to you.
  215.  
  216.     IEMSI.MSG     - Registered Version Only
  217.                     If this template exists in the same directory as Mc_Cbv.EXE
  218.                     and you automatically update IEMSI users, then this message
  219.                     will be posted to you.
  220.  
  221.     FAILPW.MSG    - Registered Version Only
  222.                     If this template exists in the same directory as Mc_Cbv.EXE
  223.                     and the user reconnects,  but gets the password wrong, then
  224.                     this message will be posted to you.
  225.  
  226.     WELCOME.MSG   - If this template exists in the same directory as Mc_Cbv.EXE
  227.                     then it will be posted to the  USER when they are verified.
  228.                     This will include  IEMSI  and  LD users if you  update them
  229.                     without doing the callback.  This can be used to  give them
  230.                     more information about joining your  BBS,  or anything  you
  231.                     desire. This message will be posted  TO the User,  From the
  232.                     Sysop as defined in Dorinfo1.Def
  233.  
  234.     NOTE: If you are NOT registered, then the ONLY Message that you may post is
  235.           WELCOME.MSG  to the  user.  A reminder is written to the  end of this
  236.           message stating that this is an  Unregistered  Evaluation  Copy,  and
  237.           requires registration after evaluating it.
  238.  
  239.  
  240. ┌─────────────────────────────────────────────────────────────────────────────┐
  241. │▓▓▓▓▓ Optional Information text files ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  242. └─────────────────────────────────────────────────────────────────────────────┘
  243.  
  244.   Mc_Cbv  allows up to  7  text files to be used to  describe the door  for the
  245.   users.  If the file isn't present then  Mc_Cbv  will use default text.  These
  246.   files should be located in the same directory as Mc_Cbv.EXE  Samples of these
  247.   files are included in the archive CBV_TEXT.ARJ
  248.  
  249.   Brief descriptions are as follows:
  250.  
  251.    The files support the RA Text File Control Codes for UserName, Phone Numbers
  252.    etc.
  253.  
  254.    ADDPHONE.TXT - Displayed to user before showing ASKPHONE.TXT
  255.  
  256.    ASKPHONE.TXT - Message to the  User to see if the  phone  number looks right
  257.                   before before calling.
  258.  
  259.    EXPLAIN.TXT  - If the user did not understand how to use the CBV,  then this
  260.                   is where you may  try to  explain it  one last time.  If they
  261.                   still do not understand, then the door will exit and you will
  262.                   have to verify them another way, or they may try again.
  263.  
  264.    GETNUM.TXT   - If you  allow the  user to enter  another  phone number to be
  265.                   called at, then this is displayed just prior to prompting for
  266.                   a phone number.  If you are using NON-USA format numbers, you
  267.                   can use this to show the user the way  YOU  WANT  the  number
  268.                   entered.
  269.  
  270.    LOCHANG.TXT  - Tells the  User why the door is  hanging up  on  them after a
  271.                   successful local callback.
  272.  
  273.    LDHANG.TXT   - Tells the  User  why the  door is hanging up  on them after a
  274.                   successful long distance callback.
  275.  
  276.    NO_LD.TXT    - Shown to Long Distance users if you don't allow LD calls.
  277.  
  278.    NOTTIME.TXT  - Shown  to  Long  Distance Users  who  you  only  call between
  279.                   certain hours.  You may use this to show what  Days and Times
  280.                   Long Distance Validation IS allowed for that users number. If
  281.                   you do not create this file,  then a nice screen  will inform
  282.                   the user of the times they may be validated.
  283.  
  284.    PRECALL.TXT  - Shown just prior to dialing the users number and explains how
  285.                   to make their modem answer when they are called.
  286.  
  287.    TELSYSOP.TXT - Message to user if  they say the  number  the door  will call
  288.                   them at doesn't look right.
  289.  
  290.    UINFO.ANS    - This is the User Information Screen.  This one allows  you to
  291.                   create an ANS and an ASC version and is displayed right after
  292.                   the Registration Info on the Screen.
  293.  
  294.  
  295.  
  296. ┌─────────────────────────────────────────────────────────────────────────────┐
  297. │▓▓▓▓▓ Data text files ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  298. └─────────────────────────────────────────────────────────────────────────────┘
  299.  
  300.   Samples are provided in the archive EXAMPLES.ARJ
  301.  
  302.   NOTE: Once you have created the MC_CBV.LOC  and  MC_CBV.LD files, I recommend
  303.         you Scan them in CBVSetup.  This option will scan these files and alert
  304.         you of any INVALID lines in these files.  This is useful if McCbv tells
  305.         you that a call is  NOT  local, when you think that it has been defined
  306.         properly within the  MC_CBV.LOC  file.  This option is available on the
  307.         EXIT Menu in CBVSetup.
  308.  
  309.  
  310.   Data Text files:  (* - means it's required)
  311.  
  312.   * Mc_Cbv.LOC - This file is used by  McCbv to tell what phone numbers will be
  313.                  LOCAL Calls. This is much like FrontDoor, where it matches the
  314.                  users number against the first number,  replacing the matching
  315.                  numbers with the dial string. Any line may be commented out by
  316.                  simply putting a semi-colon (;) in column 1.
  317.  
  318.                  The first number MUST begin at column 1 in the file, and the
  319.                  string to dial MUST start at column 25
  320.  
  321.                   123456789012345678901234567890
  322.                   416-404-                404-
  323.                   ;416-579-                579-
  324.                   804-485-                485-
  325.                   803-288-                803-288-
  326.                   ;This is a comment Field because it starts with ; in Column 1
  327.  
  328.                  In this case
  329.                         (416)404-2756 would be dialed as 404-2756
  330.                         (416)579-XXXX would NOT be found as it is commented out.
  331.                         (804)485-2995 would be dialed as 485-2995
  332.                                (803)288-2845 would be dialed as 803-288-2845
  333.  
  334.                  SPACES must be used to seperate the numbers, NOT Tabs!
  335.  
  336.                  This should make it possible to use  Mc_Cbv almost anywhere in
  337.                  the world,  all you do is define enough of the phone number to
  338.                  allow McCbv to decide the number is local,  and tell it how to
  339.                  dial it.  This makes it  easy to  support more than  one Local
  340.                  Area Code.
  341.  
  342.  
  343.                 > If you are REGISTERED you may use the following feature:
  344.  
  345.                 > If you are using North American Format numbers and you enable
  346.                 > 'Attempt Unkown Local Calls' to  Y, and a user enters a phone
  347.                 > number which matches an  AREA CODE from your Mc_Cbv.Loc file,
  348.                 > then it will ask the user if this is a  Long Distance number.
  349.                 > If the user says it is a  Local call,  then Mc_Cbv will strip
  350.                 > the area code,  and attempt to dial it  Without  using a long
  351.                 > Distance Prefix, or area code. If it reconnects with the user
  352.                 > then obviously it  IS a local call, and the proper entry will
  353.                 > be made to the  Mc_Cbv.Loc  file.  If it was,  in fact,  Long
  354.                 > distance,  you will simply get a recording from Bell,  and no
  355.                 > charges will be incurred     ( I ASSUME NO RESPONSIBILITY for
  356.                 > anything arising from using this feature. It  DOES work here,
  357.                 > I simply hear the recording and the call will fail)
  358.                 >
  359.                 > The  BARE MINIMUM  Mc_Cbv.LOC file you will need to create to
  360.                 > get started is  One Line  for each  Local Area Code. You MUST
  361.                 > enter one exchange from each area code. Eg.
  362.                 >
  363.                 >           416-404-                 404-
  364.                 >           403-215-                 215-
  365.                 >
  366.                 > From this point on,  Mc_Cbv can build your Local Control File
  367.                 > for you!!!
  368.  
  369.     Mc_Cbv.LD  - If you set YES to call Long Distance in CbvSetup, then it will
  370.                  call ANY long distance number. If you would like to limit long
  371.                  distance to certain Area Codes, or Exchanges within Area Codes
  372.                  then you may  define them  in  Mc_Cbv.LD  This file is Exactly
  373.                  like Mc_Cbv.LOC,  and if it exists,  ANY NUMBERS  which  match
  374.                  will be allowed.  In CBVSetup,  set Allow LD Calls to NO,  and
  375.                  define the ones you  WILL  call in here.  If you don't wish to
  376.                  call  any Long Distance,  or don't want to  limit the  numbers
  377.                  which can be called, then do not create this file.  Numbers in
  378.                  this file OVERRIDE the setting in CBVSetup.
  379.  
  380.                  Note: This file DOES OVERRIDE the settings in CbvSetup, but it
  381.                        WILL still honor the defined Long Distance Hours.
  382.   
  383.  
  384.                  IMPORTANT! If you wish to allow calls to TOLL numbers, that is
  385.                  numbers in your area code, which are NOT free calls,  you MUST
  386.                  define that  Area code in your  .LD file.  If you dial them as
  387.                  1-AAA-XXX-XXXX  then this is not needed,  but if you dial them
  388.                  as 1-XXX-XXXX then define your area code as follows:
  389.  
  390.                     Assume 416 is your local area code.
  391.  
  392.                     123456789012345678901234567890
  393.                     416-                    1-
  394.  
  395.  
  396.  
  397.     Mc_Cbv.LOG - Log of the doors activity.  Made by the door.
  398.  
  399.     Mc_Cbv.BAD - List of phone number NOT TO CALL (ie your local police station
  400.                  fire station, etc.)  Mc_Cbv will  automatically not call  411,
  401.                  911, 900 numbers and 555-1212 (directory assistance). You have
  402.                  to make this file if you want to define other Bad Numbers.
  403.  
  404.     Mc_Cbv.OK  - List of numbers the door has successfully called.
  405.  
  406.  
  407. ┌─────────────────────────────────────────────────────────────────────────────┐
  408. │▓▓▓▓▓ Still Having Problems? ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  409. └─────────────────────────────────────────────────────────────────────────────┘
  410.  
  411.   It is  important to us that you are able to install and run our software with
  412.   a minimum amount of effort on your part.  Although we have tried to make this
  413.   software as  easy  to use as possible,  we do know that  occasionally someone
  414.   will have a  problem.  In order to provide the  quickest response,  we have a
  415.   voice support number available,  and all problems are usually solved with one
  416.   quick phone call.  See info at the top of this file. This is the  FASTEST way
  417.   to resolve any  problems, although netmail messages will be replied to within
  418.   24 hours.
  419.  
  420.  
  421. ┌─────────────────────────────────────────────────────────────────────────────┐
  422. │▓▓▓▓▓ Special Thanks To... ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  423. └─────────────────────────────────────────────────────────────────────────────┘
  424.  
  425.   I would like to thank the following people for all their help and wisdom....
  426.  
  427.   Bob R,  Geoffrey Booher,  Bruce Bodger,  David Smart,  Chuck Corvec,  and
  428.   all those who contacted me with problems and helped to test the fixes...
  429.  
  430.   Special thanks to Mark McKay, who wrote the original code which this door
  431.   is based on, and Peter Kling, and Jeff Wilson who each helped out as well.
  432.  
  433.   And, of course, Andrew Milner, for such a fantastic Bulletin Board System!
  434.  
  435.   The biggest thanks of all go to those who have already registered this
  436.   program, setting a record here at Motor City Software for the number of
  437.   registrations received within the shortest time of a first release!!!
  438.  
  439.  
  440.   Rod Hancock
  441.   Motor City Software
  442.  
  443.  
  444. <end of document>
  445.